Actualizar Contacto


Actualización

Para actualizar un contacto debemos agregar un token en Headers de tipo Authorization con el token necesario, este token deben solicitarse a Domus.
Es importante anotar que los parámetros deben ser enviados a través de algo como form_params o similar, no se deben enviar directamente en la URL.

Antes se deben consultar los métodos generales de tipos de teléfono, indicativos de teléfono y recursos.

Importante (actualización parcial): El endpoint actualiza los datos basándose estrictamente en el payload recibido. Para evitar la pérdida de información, omite en tu petición los atributos que no requieran cambios. Cualquier llave enviada en el JSON sobrescribirá el valor actual del registro.

Ejemplo de uso

{success} PUT: /api/public/contacts/contactId

use GuzzleHttp\Client;

$client = new Client();
$res = $client->request("PUT", "{$endpoint}/api/public/contacts/{$id}", [
    "form_params" => [
        "name": "Nombre contacto",
        "last_name": "Apellidos contacto", 
        "email": "[email protected]",
        "origin": 2,
        "birthdate": "2024-02-06", 
        "description": "Descripción para el contacto", 
        "identification": "1026295959",
        "branch": 3,
        "tags": [2,3] //Etiquetas que se quieren agregar,
        "delete_tags": [1,4] //Etiquetas que se quieren remover del contacto
        "phones": [
            {
                "phone": "3215453585", 
                "phone_type": 2, 
                "phone_indicative": 1, 
            },
            {
                "phone": "31569959",
                "phone_type": 1, 
                "phone_indicative": 2,
            },
        ]
    ]
]);

$contact = json_decode($res->getBody(), true);
return $contact;

Ejemplo de respuesta

{
    "code": 200,
    "message": "Contacto actualizado",
    "data": {
        "name": "Nombre contacto",
        "last_name": "Apellidos contacto",
        "email": "[email protected]",
        "identification": "1026295959",
        "birthdate": "2024-02-06",
        "description": "Descripción para el contacto",
        "picture_url": "www.link_photo.com",
        "contact_status_id": 1,
        "contact_status_type_id": 1,
        "source_id": 2,
        "platform_id": 1,
        "last_gestion_date": "2024-04-10T21:31:40.236031Z",
        "profile_id": 4,
        "created_by_id": 1,
        "updated_by_id": 1,
        "branch_id": 1,
        "company_id": 1,
        "country_id": 1,
        "temperature_value": "20",
        "temperature_id": 1,
        "updated_at": "2024-04-10T21:31:40.000000Z",
        "created_at": "2024-04-10T21:31:40.000000Z",
        "id": 171
    }
}

Parámetros que recibe

Por From Params

Estos son los valores requeridos para la creación del usuario

Parámetro Descripción Ejemplo
name Nombre del contacto Camille
last_name Apellido del contacto Vasquez
identification Identificación del contacto 10161600
email Email de la persona [email protected]
description Description de la persona Interesando en ...
birthdate Cumpleaños de la persona 2024-02-06
phones Teléfono del contacto {}
origin Recurso o portal del cual se contacto 2
branch Sucursal a la cual se quiere asignar el contacto 3
tags Agrega etiquetas al contacto []
delete_tags Elimina etiquetas al contacto []